Open Specified Card

Description

Opens the specified Pickering card, clearing all of its outputs. Once a card has been opened, other driver functions may then be used to access it.

If the card is currently opened by some other program it cannot be accessed and the function returns an error.

Prototype

DWORD PIPLX_OpenSpecifiedCard(SESSION session, DWORD Bus, DWORD Slot, DWORD *CardNum);

Parameters:

Session - The session variable obtained from the PICMLX_Connect call

Bus - the card's logical bus location

Slot - the card's logical slot location

CardNum - pointer to variable to receive the card's logical card number

Returns:

Zero for success, or non-zero error code.

Note

The logical Bus and Slot values corresponding to a particular card are determined by system topology; values for cards that are operable by the Piplx driver can be discovered using PIPLX_FindFreeCards.